home *** CD-ROM | disk | FTP | other *** search
/ Enter 2002 November / EnterCD 11_2002.iso / Internet / Amaya 6.4 / Windows NT.exe / _SETUP.1 / the_saveas_command.html < prev    next >
Encoding:
Extensible Markup Language  |  2002-06-11  |  8.2 KB  |  191 lines
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3.     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml">
  5. <head>
  6.   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  7.   <meta name="GENERATOR" content="amaya 5.3, see http://www.w3.org/Amaya/" />
  8.   <title>The Save As Command</title>
  9.   <style type="text/css">
  10.   </style>
  11.   <link href="../style.css" rel="stylesheet" type="text/css" />
  12. </head>
  13.  
  14. <body xml:lang="en" lang="en">
  15.  
  16. <table border="0" summary="toc">
  17.   <tbody>
  18.     <tr>
  19.       <td><img alt="W3C" src="../../images/w3c_home" /> <img alt="Amaya"
  20.         src="../../images/amaya.gif" /></td>
  21.       <td><p><a href="the_save_command.html" accesskey="p"><img
  22.         alt="previous" src="../../images/left.gif" /></a> <a
  23.         href="../Publishing.html" accesskey="t"><img alt="top"
  24.         src="../../images/up.gif" /></a> <a
  25.         href="saving_documents_as_text.html" accesskey="n"><img alt="next"
  26.         src="../../images/right.gif" /></a></p>
  27.       </td>
  28.     </tr>
  29.   </tbody>
  30. </table>
  31.  
  32. <div id="page_body">
  33. <h1>The Save As Command</h1>
  34.  
  35. <p>Choosing <strong>Save As</strong> from the <strong>File</strong> menu
  36. opens the <strong>Save As</strong> dialog, where you can: save the document
  37. as XML, HTML, or as a text file to a local disk or a remote URI; save
  38. embedded images into the same document directory or a different location; and
  39. transform embedded URIs.</p>
  40.  
  41. <h2>The Save As Dialog</h2>
  42.  
  43. <p>The items in the dialog box, from top to bottom, left to right are used as
  44. follows:</p>
  45. <ul>
  46.   <li>The <strong>Document format</strong> offers a choice between
  47.     <strong>HTML</strong>, <strong>XML</strong> (XHTML) and
  48.     <strong>Text</strong> for HTML documents. This submenu is not shown when
  49.     saving a SVG, a MathML, a CSS, or any other document type. By default,
  50.     Amaya keeps the current document format. The entry <strong>Text</strong>
  51.     removes the HTML mark-up and replaces it by spaces, newlines, and so on. 
  52.     <p></p>
  53.   </li>
  54.   <li>The <strong>Document location</strong> field indicates where the file
  55.     is to be written. This can be a file in the local file system (for
  56.     example, <code>/pub/html/welcome.html</code>) or the name of a remote URI
  57.     (for example, <code>http://www.w3.org/pub/WWW/Welcome.html</code>). 
  58.     <p></p>
  59.     <p class="Note"><strong>Note:รกรกรก</strong><span xml:lang="EN" lang="EN"
  60.     style="font-weight:normal">Use</span><strong><span></span></strong>a
  61.     complete path for the URL. You should also make sure that you have the
  62.     rights to do a <code>PUT</code>method if it is a remote location. Refer
  63.     to the page on <a
  64.     href="http://www.w3.org/Amaya/User/Put.html">configuring your server to
  65.     accept the PUT method</a> or ask your Web administrator.</p>
  66.     <p></p>
  67.   </li>
  68. </ul>
  69. <ul>
  70.   <li>The <strong>Copy Images</strong> toggle indicates whether the images
  71.     embedded in the current document must be copied along with the document
  72.     to the new location. It's generally better to keep this switch on as
  73.     otherwise you will not be sure that the corresponding images will be
  74.     found when opening the document later. However, switching it off is
  75.     useful when you have only changed the text of the document and the
  76.     document is stored on the same server. When images are copied, Amaya will
  77.     automatically update all <strong>SRC</strong> attributes to point new
  78.     image locations. New locations will be relative URIs. 
  79.     <p></p>
  80.   </li>
  81.   <li>The <strong>Transform URIs</strong> toggle transforms all current URIs
  82.     into relative URIs when possible. Of course, if the document is saved in
  83.     a local file and URIs point to remote files, URIs will be absolute. This
  84.     ensures that all the links in the document remain correct after the copy.
  85.     However, if you have several document linked together with relative URIs
  86.     and you plan to move them to a remote location, you must disable URI
  87.     conversion to avoid referencing the initial locations. 
  88.     <p></p>
  89.   </li>
  90.   <li>The <strong>Images location</strong> field allows you to save images
  91.     (if <strong>Copy Images</strong> has been selected) to a different place
  92.     than the HTML file. This field should contain the name of a directory on
  93.     the local file system or a location on the remote server. 
  94.     <p></p>
  95.     <ul>
  96.       <li>Using a relative path, the images are stored at a location relative
  97.         to the document directory. For example, if the document location is
  98.         <code><a
  99.         href="http://www.w3.org/pub/WWW/Welcome.html">http://www.w3.org/pub/WWW/Welcome.html</a><a
  100.         href="http://www.w3.org/pub/WWW/Welcome.html"></a></code> and the
  101.         images location is "Images", an image "W3C.png" contained in the
  102.         document is stored at the URI <code><a
  103.         href="http://www.w3.org/pub/WWW/Images/W3C.png">http://www.w3.org/pub/WWW/Images/W3C.png</a></code>
  104.         and the HTML file is modified to reference it as: 
  105.         <p></p>
  106.         <p><code><img src="Images/W3C.png"></code></p>
  107.         <p></p>
  108.         <p>This is similar in the case of a document location on the local
  109.         file system.</p>
  110.         <p></p>
  111.       </li>
  112.       <li>Using an absolute path, the images are stored at this exact
  113.         location, independently of the document location. In the previous
  114.         example, if the specified images location is
  115.         <code>http://pub/WWW/Images</code>, the image is stored at
  116.         <code>http://www.w3.org/pub/WWW/Images/W3C.png</code> and the
  117.         corresponding HTML file is modified in the following way: 
  118.         <p></p>
  119.         <p><code><img src="Images/W3C.png"></code></p>
  120.       </li>
  121.     </ul>
  122.   </li>
  123. </ul>
  124.  
  125. <p>Several buttons are at the bottom:</p>
  126. <ul>
  127.   <li>Clicking <strong>Confirm</strong> starts the process of transforming
  128.     the document. A dialog asks for confirmation in both of the following
  129.     cases: 
  130.     <ul>
  131.       <li>The document has to be saved on a remote server. Amaya displays the
  132.         complete URI to be written to for verification.</li>
  133.       <li>The document has to be saved locally and the file already exists. 
  134.         <p></p>
  135.       </li>
  136.     </ul>
  137.   </li>
  138.   <li>When saving to a remote location, check that the http_proxy is not set,
  139.     or that the proxy server and the <a
  140.     href="http://www.w3.org/Amaya/User/Put.html">target server are configured
  141.     to work with the PUT</a> method. 
  142.     <p></p>
  143.   </li>
  144.   <li>Amaya does not currently contact the remote server (in case of an
  145.     <code>http://...</code> destination) to check whether such a document
  146.     already exists. 
  147.     <p></p>
  148.   </li>
  149.   <li>Clicking <strong>Browse</strong> lets you select a local directory and
  150.     file name: 
  151.     <ul>
  152.       <li>The <strong>Document directories</strong> field shows the
  153.         directories contained in the current directory. It should be used to
  154.         save a file on the local file system.</li>
  155.       <li>The <strong>Files</strong> field shows the files contained in the
  156.         current local directory. 
  157.         <p></p>
  158.       </li>
  159.     </ul>
  160.   </li>
  161.   <li>Clicking <strong>Clear</strong> removes the current contents of both
  162.     the <strong>Document location</strong> field and the <strong>Images
  163.     location</strong> field. 
  164.     <p></p>
  165.   </li>
  166.   <li>Clicking <strong>Change Charset</strong> opens a pop-up window that
  167.     enables you to change the charset of the document. This option only works
  168.     with documents that support the notion of charset, such as HTML and XML
  169.     ones. This option is available when saving both remote and local
  170.     documents. 
  171.     <p></p>
  172.   </li>
  173.   <li>Clicking <strong>Change Mime Type</strong> opens a pop-up window where
  174.     you can select the MIME type of the document. If the MIME type you're
  175.     looking for is not listed, you can type it in yourself. This button is
  176.     only active when saving a document to a server (local file systems don't
  177.     store the MIME metadata information.). 
  178.     <p></p>
  179.   </li>
  180.   <li>Clicking <strong>Cancel</strong> terminates the command.</li>
  181. </ul>
  182.  
  183. <h2>See also:</h2>
  184. <ul>
  185.   <li><a href="the_save_command.html">The Save Command</a></li>
  186. </ul>
  187. </div>
  188.  
  189. </body>
  190. </html>
  191.